Luma X20 Fisheye IP Camera Driver Documentation

Driver download(missing or bad snippet)
Luma_IP_Fisheye_Camera_x20 2.c4z
------------------------------------------------------------------------------------------

Manufacturer Website: http://www.snapone.com

Support Site: https://snapone.com/contact-us/

Help Guide: https://help.snapone.com/luma-x20-guide/Content/Intro.htm

-------------------------------------------------------------------------------------------

Overview

-------------------------------------------------------------------------------------------

This driver integrates a Luma X20 Fisheye IP Camera into Control4. This device can be discovered via SDDP and should be identified that way to ensure connectivity if the IP changes. The driver will configure itself and expose the feature set in the navigators according to the model camera connected to the driver. For example, a Fisheye camera will expose Fisheye specific settings.

Device Compatibility

LUM-1220-IP-FISH-W

Stream Views

Fisheye View
Panoramic View
PTZ 1
PTZ 2
PTZ 3

-------------------------------------------------------------------------------------------

Setup

-------------------------------------------------------------------------------------------

Warning: Read the requirements before using this driver.

Requirements:

When using this driver first activate the camera through app.ovrc.com. Activating the device through OVRC creates the authentication information needed for this driver. Once the device has been activated through OVRC, use the SystemConnect username and the unique auto generated password created by OVRC. This can be found in the Configuration Menu within the OVRC device.

MINIMUM OS VERSION 3.3.2

The controller must be on at least 3.3.2 for this driver to be added and function correctly.

Control4 T3 Touchpanel Disclaimer

While the Control4 T3 touchscreen will function with Luma X20 cameras, it does not support the full range of advanced features. For the optimal Luma X20 experience, upgrading to the Control4 T4 touchscreen is strongly recommended.

Control4 T4 Series In-Wall Touchscreen
https://www.snapav.com/shop/en/snapav/control4-t4-series-10-in-wall-touchscreen-c4-t4iw10-a

-------------------------------------------------------------------------------------------

 

Single Driver Setup

-------------------------------------------------------------------------------------------
The driver can be setup where only one driver is added to the project and via the navigators camera settings menu the streaming view can be changed. 

-------------------------------------------------------------------------------------------

 

Multi-Driver Setup

-------------------------------------------------------------------------------------------
The driver can be setup where multiple drivers are added to the project and each driver could be configured via the Fisheye Stream View property to show a different view. Disclaimer that only 10 concurrent streams can be made at a time. Any additional streams may result in black screen or stream error.
-------------------------------------------------------------------------------------------

History Events

-------------------------------------------------------------------------------------------

1. If the notification property is enabled, the driver will automatically subscribe to Motion Detection, Line Crossing, and Region Intrusion events and will automatically be routed to the history agent when an event of those types is triggered. These will contain a snapshot of what they have detected. These will be saved for 7 days. Ensure Motion Detection, Line Crossing and/or Region Intrusion is properly configured via OvrC or the Web UI.

-------------------------------------------------------------------------------------------

Notifications [New to 3.4.0]

-------------------------------------------------------------------------------------------

1. Push notifications can be enabled for Motion Detection, Line Crossing, and Region Intrusion and are off by default.  To turn these on, enable the Event Toggle property and the Automatic Notifications property. Then go to your Control4 app → Settings → Select the system you are connecting to → Notifications → Cameras.  Select the individual camera and choose the event you’d like to enable. Ensure Motion Detection, Line Crossing and/or Region Intrusion is properly configured via OvrC or the Web UI.

2. Once notifications are enabled for your cameras, you will start getting notifications on your device.  It will include a snapshot of the event as well as a link that will take you to the event or to the live view depending on how soon after the event you click on the device.
-------------------------------------------------------------------------------------------

Properties

-------------------------------------------------------------------------------------------

Driver Version - indicates the current driver version.

Network Status - ndicates the current network status.

Device Name - indicates the current device name.

MAC Address - indicates the current MAC Address.

Model - indicates the current device model.

Software Version - indicates the current software version.

Service Tag - indicates the current service tag.

Fisheye Stream Mode - indicates the current mode the fisheye is in.

Fisheye Stream View - indicates the current view the fisheye driver is configured to display.

Fisheye View Name - a friendly name shown in the camera settings menu for the 360 degree view.

Panoramic View Name - a friendly name shown in the camera settings menu for the panoramic view.

PTZ 1 View Name - a friendly name shown in the camera settings menu for PTZ 1.

PTZ 2 View Name - a friendly name shown in the camera settings menu for PTZ 2.

PTZ 3 View Name - a friendly name shown in the camera settings menu for PTZ 3.
Audio - reflects the current audio status.

Connection Method - selector for choosing which method this camera is configured.

Switch - select this option if your camera is connected directly to a PoE switch.

NVR - select this option if your camera is connected behind a X20 NVR.

NVR PoE Number - only visible when NVR connection method is selected. Selector to pick which port the camera is connected to behind the NVR. If the fisheye camera was plugged into port 3, this would be 3.

NVR Channel Number - only visible when NVR connection method is selected. Selector to pick which channel number was assigned for the view you want behind the NVR. If the fisheye view was assigned channel 3 and the panoramic view was assigned channel 4, this property would be channel 4. If PTZ 1 view was assigned channel 5, this property would be channel 5.

PTZ Speed - only visible when connected to a PTZ IP camera. Sets the speed at which PTZ functions execute.

Notifications Note - note explaining that when the camera is configured to be behind the NVR,     notifications should be setup using the NVR Manager Driver.

Event Subscription Status - indicates the current status of the drivers connection to the camera and subscription     for events.

Event Toggle - enable or disable listening for smart events.

Automatic Notifications - enable or disable the smart events into Control4s push notifications and history view.

DEBUG MODE - used for debugging the lua output window

-------------------------------------------------------------------------------------------

Events

-------------------------------------------------------------------------------------------

Motion Detection

Event that fires when motion is detected in an area of interest. If a contact sensor is bound, when motion is detected the contact will open, then after the configured alarm holding time expires, the contact will close again.

Line Crossing

Event that fires when a human, motor vehicle, or non-motor vehicle is detected in an area of interest. If a contact sensor is bound, when object crosses the configured line the contact will open, then after the configured alarm holding time expires, the contact will close again.

Region Intrusion

Event that fires when a human, motor vehicle, or non-motor vehicle is detected in an region of interest. If a contact sensor is bound, when object enters the configured region the contact will open, then after the configured alarm holding time expires, the contact will close again.

-------------------------------------------------------------------------------------------

Actions

-------------------------------------------------------------------------------------------

Reboot Camera

Will cause the camera to reboot - It may be several minutes before the camera is back online.

Add and Connect Contacts

Creates and auto binds contacts to this driver's contact sensor connections.

-------------------------------------------------------------------------------------------

Device-Specific Commands

-------------------------------------------------------------------------------------------

Reboot Camera

Will cause the camera to reboot - It may be several minutes before the camera is back online.

Privacy Mask

Set privacy mask on/off.

-------------------------------------------------------------------------------------------

Change Log

-------------------------------------------------------------------------------------------

V4 - Fixed bug where notifications wouldn’t hide on a nvr connection method

V3 - Broke out Notifications property into Event Toggle and Automatic Notifications for finer control of events in the system.
Removed automatic add of contact sensor of first enable of Event Toggle property
One time migration of Notifications property to new properties.

V2 - Added support for NVR connection method
Added support for substream with ePTZ Channels

V1 - Release

-------------------------------------------------------------------------------------------